home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / more13.zip / MORE.DOC < prev    next >
Text File  |  1990-06-26  |  11KB  |  208 lines
  1. MORE.EXE v1.3 -- File Pager
  2.  
  3.     First  and    foremost,  MORE  now  requires    DOS  v3.0  or  later to run. No
  4. exceptions. If    you have  a version  of DOS  earlier than  3.0, you  can either
  5. upgrade (recommended), or you can use MORE v1.1 (which is still available.)
  6.  
  7.     The MORE archive includes the following files:
  8.         MORE.DOC    this documentation file
  9.         MORE.EXE    MORE itself
  10.         RUN.COM     used for executing batch files from MORE
  11.         MORE.C        The source code for MORE
  12.  
  13.         STRINGS.COM    Analyzes binary files for text strings
  14.         STRINGS.DOC    Document for STRINGS.COM
  15.  
  16.     MORE  itself  creates  the    configuration  file (MORE.CFG) in the directory
  17. containing MORE.EXE. Therefore,  this file is  not included in    the archive. If
  18. the  file  is  not  found,  the  information  is  read from a table of internal
  19. defaults.
  20.  
  21.     MORE is a program which (essentially)  allows you to scroll through a  file
  22. and examine its contents.
  23.  
  24. There are two ways to use MORE:
  25.     MORE <filename>
  26.     or, like the DOS more:
  27.     TYPE <filename> | MORE
  28.  
  29.     Either way, your file will be read in. If MORE is unable to read your  file
  30. (such as if you left your drive open or the file doesn't exist), it will inform
  31. you: "more: unable  to open file".  If you supply  more than two  arguments, it
  32. will inform you as to the syntax.
  33.  
  34.     However, if you forget to include a filename of some sort, it will just sit
  35. there with the cursor flashing, waiting for input. The easiest way out of  this
  36. mess is to press ^Z  and Enter. Then press ESC    to exit. Next time remember  to
  37. include a filename. (This  is due to the  fact that if you  don't redirect, the
  38. standard  input  --  which  MORE  reads  if  no  filename is supplied -- is the
  39. keyboard.)
  40.  
  41.     After MORE has read  your file, you can  scroll through it using  the arrow
  42. keys. The Up and Down arrow keys scroll one line up or down; the PgUp and  PgDn
  43. keys scroll a  page. The Right    and Left arrow    keys scroll 20    columns left or
  44. right. The Home and End keys go to the beginning and end of the file. Ctrl-PgUp
  45. and Ctrl-PgDn scroll half pages. To exit (after you have read the file),  press
  46. Escape.  Your  current    position  within  the  file is shown in the upper-right
  47. corner of the screen, in the form of Line, Column. Pressing F1 will show a list
  48. of possible operations.
  49.  
  50.     MORE also features    searching functions. There  are two types  of searches,
  51. normal and case sensitive. The normal search thinks that A and a are  identical
  52. for example, but to  the case sensitive search    they wouldn't be. The  searches
  53. will only search beyond  the current line (the    line at the top  of the screen)
  54. and will not find a word ON the current line.
  55.  
  56.     To use the searches,  push 'F' (for a  standard search) or 'C'  (for a case
  57. sensitive search.). Then type the word or phrase you would like to search  for.
  58. You can search for up to 65 characters at a time.
  59.  
  60.     If the find routine is unable to locate the phrase, the computer will  beep
  61. and the screen will remain where it was. If it was able to locate it, then  the
  62. screen will move so the line containing the phrase is at the top of the screen.
  63.  
  64.     If you would like to repeat a search,  use 'N' or 'B' -- find Next or  find
  65. Backward. The find  next command works    as if you  retyped Find and  the phrase
  66. you're looking for. However, the backward command looks BEFORE the current line
  67. for the phrase. This is useful if you accidently went to far, for example.
  68.  
  69.     If you want to cancel the search, press Escape. ONCE! If you press it  more
  70. than once, MORE will exit to the DOS prompt. It may take a while for the search
  71. to end.
  72.  
  73.     You can also  search for lines.  To do this,  press 'L', and  then type the
  74. number of the line you    want to find. (If the  line doesn't exist, or what  you
  75. type isn't a number, the program beeps at you.)
  76.  
  77.     You can also store locations in the file for looking at later -- a    feature
  78. called bookmarks. To use  this, type 'S', and  then type a number  and enter to
  79. set the bookmark. Any number 0-9 is usable. (If what you type is not a    number,
  80. the computer will beep at you). Then, when you want to go back to it, type  'G'
  81. and the number again.  (If what you type  is not a number,  again, the computer
  82. will beep. It will also beep if you haven't defined that bookmark yet.)
  83.  
  84.     Blocks  are  used  in  MORE  to  select  text  to be written to the disk or
  85. printed. When you define blocks, the line at the top of the window (the current
  86. line, under the top  information line) is selected.  The text you mark    for the
  87. block is highlighted.
  88.  
  89.     To define a block, use the '+' key to set the top of the block and the  '-'
  90. key to set the bottom of the block. (Either set will work.) But make sure  that
  91. the line you want to mark is at the very top of the screen!
  92.  
  93.     To clear the block, press '*' (again, either one will do). Note that this
  94. does not erase the block, but only unmarks it.
  95.  
  96.     To print the entire file, press 'A'.
  97.  
  98.     If you decide  to cancel printing  after it started,  press Escape. It  may
  99. take a    while, but  do NOT  repeat the    keystroke unless  you want to exit. The
  100. keystroke will register as soon as the    program has an has a chance to    look at
  101. the keyboard.
  102.  
  103.     You can write  either a block,  or the whole  file, to another  file. To do
  104. this, type 'D' to write the current block (if no block is defined, MORE beeps).
  105. Then type  the name  of the  file you  want to    write to.  If the  file already
  106. exists, you  are given    three choices.    Push 'Y'  if you  want to overwrite the
  107. file, push 'N' (or Esc) to cancel, or push 'A' to append the text to the  file.
  108. Writing the whole file uses the same process, but type 'W' instead of 'D'.  You
  109. can use Esc to cancel the write. The file will be deleted UNLESS you  specified
  110. to append to an existing file (if you did, then you have to clean up the mess.)
  111.  
  112.     If the file was  collected from the standard  input, you wrote it  out, and
  113. you did not append it on to another file, MORE will change the top line to show
  114. the name of the file you wrote it out to, and will let you use the 'E' command.
  115.  
  116.     To call up an editor from MORE, first set it up (exact procedure  described
  117. below). Then you push  "E". If the file  was collected from the  standard input
  118. and not written to disk using the "W" command, this will be ignored. MORE  does
  119. not return after your  editor has ended.
  120.  
  121.     MORE does  have some  limits. You  can't load  files larger  than available
  122. memory and  lines are  limited to  2048 characters  in length.    MORE can't read
  123. binary files (such  as program files)  except with the    help of a  program like
  124. STRINGS (which is included).  No problems will occur,  but the results will  be
  125. somewhat wierd.
  126.  
  127.     If you  go beyond  the limits  set forth  in the  program, the program will
  128. politely inform  you with  a message  like "more:  insufficient memory".  Lines
  129. longer than 2048 characters will  be split into multiple lines.  However, after
  130. such a split, tab characters become small circles and don't space properly.  In
  131. fact, this can happen to any long line.
  132.  
  133.     Normally, MORE  displays the  name of  the file  you're viewing  on the top
  134. line, but if it is too long,  it displays a copyright message instead. It  will
  135. also display the copyright message if the input was collected from the standard
  136. input as no filename is available.
  137.  
  138.     To set  up MORE,  you use  the keys  F7 through  F10. F7 changes the screen
  139. colors. To use this, simply use the Up/Down arrows to move the pointer (->)  to
  140. the color that you would like to change, and then use the Left/Right arrows  to
  141. increment or decrement the number. Both wrap. The line at the top of the screen
  142. shows the numbers for background and foreground colors, and the three lines  at
  143. the  bottom  of  the  screen  show  the  colors currently selected. To exit the
  144. color-changing mode, hit Esc, which also  redraws the screen in the colors  you
  145. selected.
  146.  
  147.     To    change    the  printer  port,  push  F8.    Then you can either enter a new
  148. printer port (the logical DOS file used for output to the printer) or press Esc
  149. to cancel the operation.